home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / ansitape.z / ansitape
Text File  |  1998-10-20  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4. aaaannnnssssiiiittttaaaappppeeee((((1111))))                                                        aaaannnnssssiiiittttaaaappppeeee((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ansitape - ANSI standard tape handler
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      aaaannnnssssiiiittttaaaappppeeee [key] [keyargs] [files]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _a_n_s_i_t_a_p_e reads and writes magnetic tapes written in ANSI standard format
  16.      (called ``Files-11'' by DEC).  Tapes written by _a_n_s_i_t_a_p_e are labeled with
  17.      the first six characters of the machine name by default.  Actions are
  18.      controlled by the _k_e_y argument.  The _k_e_y is a string of characters
  19.      containing at most one function letter.  Other arguments to the command
  20.      are a tape label and filenames specifying which files are to be written
  21.      onto or extracted from the tape.
  22.  
  23.      Note that this version is designed to work with text files that is, those
  24.      with no more than 2044 bytes without a newline character.  Binary files
  25.      are unlikely to be handled correctly on either creation or extraction.
  26.  
  27.      The function portion of the key is specified by one of the following
  28.      letters:
  29.  
  30.      rrrr       The named files are written at the end of the tape.  The cccc
  31.              function implies this.
  32.  
  33.      xxxx       The named files are extracted from the tape.  If no file argument
  34.              is given, the entire contents of the tape are extracted.  Note
  35.              that if the tape has duplicated filenames, only the last file of
  36.              a given name can be extracted.
  37.  
  38.      tttt       The names of the specified files are listed each time they occur
  39.              on the tape.  If no file argument is given, all files on the tape
  40.              are listed.
  41.  
  42.      cccc       Create a new tape; writing begins at the beginning of the tape
  43.              instead of after the last file.  This command implies rrrr....
  44.  
  45.      The following characters may be used in addition to the letter that
  46.      selects the function desired.
  47.  
  48.      ffff       This argument allows the selection of a different tape device.
  49.              The next word in the _k_e_y_a_r_g_s list is taken to be the full name of
  50.              a local device on which to write the tape.  The default is
  51.              /_d_e_v/_t_a_p_e.
  52.  
  53.      nnnn       The nnnn option allows the user to specify, as the next argument in
  54.              the _k_e_y_a_r_g_s list, a control file containing the names of files to
  55.              put on the tape.  If the filename is '-', the control file will
  56.              instead be read from standard input.  The control file contains
  57.              one line for each file placed on the tape.  Each line has two
  58.              names, the name of the file on the local machine and its name
  59.              when placed on the tape.  This allows for a convenient flattening
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaannnnssssiiiittttaaaappppeeee((((1111))))                                                        aaaannnnssssiiiittttaaaappppeeee((((1111))))
  71.  
  72.  
  73.  
  74.              of hierarchies when placing them on tape.  If the second name is
  75.              omitted, the UNIX filename will also be used on the tape.  This
  76.              argument can only be used with the rrrr and cccc functions.
  77.  
  78.      llll       The llll option allows the user to specify the label to be placed on
  79.              the tape.  The next argument in the _k_e_y_a_r_g_s list is taken as the
  80.              tape label, which will be space padded or truncated to six
  81.              characters.  This option is meaningless unless cccc is also
  82.              specified.
  83.  
  84.      vvvv       Normally _a_n_s_i_t_a_p_e works relatively silently.  The vvvv (verbose)
  85.              option causes it to type information about each file as it
  86.              processes it.
  87.  
  88.      bbbb       The bbbb option allows the user to select the block size to be used
  89.              for the tape.  By default, _a_n_s_i_t_a_p_e uses the maximum block size
  90.              permitted by the ANSI standard, 2048.  Some systems will permit a
  91.              much larger block size, and if large files are being put on the
  92.              tape, it may be advantageous to do so.  _a_n_s_i_t_a_p_e takes the next
  93.              argument of the _k_e_y_a_r_g_s list as the block size for the tape.
  94.              Values below 18 or above 32k will be limited to that range.  The
  95.              standard scale factors b=512 and k=1024 are accepted.
  96.  
  97.      FFFF       The FFFF flag allows _a_n_s_i_t_a_p_e to write ANSI 'D' format-fixed
  98.              record-length tapes.  The next two keyargs must be the recordsize
  99.              and blocksize, with the same scale factors and range limits as
  100.              the bbbb option.  The files to be written by the FFFF flag must be in
  101.              fixed format on the UNIX end-all lines should be _e_x_a_c_t_l_y rrrreeeeccccoooorrrrdddd----
  102.              ssssiiiizzzzeeee bytes long plus a terminating newline (which will be
  103.              discarded).  Note that this is exactly the same format produced
  104.              by _a_n_s_i_t_a_p_e when reading an ANSI 'D' format tape.
  105.  
  106.      _a_n_s_i_t_a_p_e will not copy directories, character or block special files,
  107.      symbolic links, sockets, or binary executables.  Attempts to put these on
  108.      tape will result in warnings, and they will be skipped completely.
  109.  
  110. FFFFIIIILLLLEEEESSSS
  111.      /dev/tape default tape drive
  112.  
  113. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  114.      A warning message will be generated when a record exceeds the maximum
  115.      record length, and the affected file will be truncated.
  116.  
  117. BBBBUUUUGGGGSSSS
  118.      _a_n_s_i_t_a_p_e quietly truncates names longer than 17 characters.
  119.  
  120.      Multivolume tapes can be read (provided no files cross the volume
  121.      boundary) but not written.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. aaaannnnssssiiiittttaaaappppeeee((((1111))))                                                        aaaannnnssssiiiittttaaaappppeeee((((1111))))
  137.  
  138.  
  139.  
  140. SEE ALSO
  141.      vmsprep(1), mtio(7).
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.